TSpinDblEdit and TDBSpinDblEdit Version 1.5e (c) copyright 1996-97 W. Braun All Rights Reserved Delphi 1-3 / C++ Builder VCL-Komponenten Liebe Entwickler und Anwender , mit diesen Komponenten können Sie alle numerischen Ein-/Ausgabefelder in Ihrer Applikation abdecken und erreichen so ein einheitlich formatiertes Erscheinungsbild Ihrer Anwendung. Ich hoffe diese Komponenten helfen euch bei der Arbeit und machen diese etwas leichter. Inhalt 1. Installation 2. Neu 3. Eigenschaften 4. Funktiosbeschreibung 5. Registrierung 6. Glossar 7. Warranty 8. Shareware 1. Installation I. Delphi 1-2 Bitte benutzen Sie für die 16-Bit Version die Datei "D_16.ZIP" und für die 32-Bit Version die Datei "D_32_2.ZIP". 1. Kopieren Sie bitte die Dateien DEdSpin.DCU, DEdSpin.DCR, DEdSpin.RES, Calc.DCU und Calc.DFM in ein beliebiges von Ihnen bevorzugtes Verzeichniss, z.B. C:\DELPHI\Z_COMP 2. Wählen Sie im Delphi-Menü Optionen | Komponenten installieren 3. Klicken Sie auf Hinzufügen 4. Geben Sie jetzt das Verzeichniss und DEDSPIN.DCU ein, z.B. C:\DELPHI\Z_COMP\DEDSPIN.DCU 5. Klicken Sie jetzt OK 6. Nochmal OK II. Delphi 3 Bitte benutzen Sie die Datei "D_32_3.ZIP" 1. Kopieren Sie bitte die Dateien DEdSpin.DCU, DEdSpin.DCR, DEdSpin.RES, Calc.DCU und Calc.DFM in ein beliebiges von Ihnen bevorzugtes Verzeichniss, z.B. C:\DELPHI\Z_COMP 2. Wählen Sie im Delphi-Menü Komponenten | Komponenten installieren 3. Wählen sie ihre bevorzugte package ( default dclusr30dpk) und klicken Sie auf Hinzufügen 4. Geben Sie jetzt das Verzeichniss und DEDSPIN.DCU ein, z.B. C:\DELPHI\Z_COMP\DEDSPIN.DCU 5. Klicken Sie jetzt Compilieren 6. Folgen Sie den Anweiseungen bis zur Meldung, daß TSpinDblEdit unf TDBSpinDblEdit registriert sind, erscheint 7. Speichern Sie das package ab. III. C++ Builder Bitte benutzen Sie für die Datei "D_CB.ZIP" 1. Kopieren Sie bitte die Dateien DEdSpin.OBJ, DEdSpin.HPP, DEdSpin.DCR, DEdSpin.RES, Calc.OBJ, Calc.HPP und Calc.DFM in ein beliebiges von Ihnen bevorzugtes Verzeichniss, z.B. C:\CBUILDER\Z_COMP 2. Wählen Sie im Menü Optionen | Komponenten installieren 3. Klicken Sie auf Hinzufügen 4. Geben Sie jetzt das Verzeichniss und DEDSPIN.OBJ ein, z.B. C:\CBUILDER\Z_COMP\DEDSPIN.OBJ 5. Klicken Sie jetzt OK 6. Nochmal OK Nach kompilierung der VCL durch Delphi/C++ Bulder erscheint jetzt in Ihrer Komponenten-Leiste eine zusätzliche Leiste 'WB', hier finden Sie die neuen Komponenten. Jetzt müssen Sie nur noch diese Komponenten anklicken und danach auf Ihr Formular an der gewünschten Position setzen. 2. Neu Version 1.5e (08.08.1997) -die Tasten ALt+Hoch/Runter öffnen den Taschenrechner (wie ComboBox) Anregung von Thomas Grusche, 100027.231@compuserve.com -Eigenschaft ActiveColor Anregung von G.Schmitthenner, Calcul-Schmitthenner@t-online.de -Eigenschaft CalcColor -Fehlerbehebung bei Ctl3D = False -Vererbte Eigenschaften wie BorderStyle sind nun auch in Delphi 2+3 voll veröffentlicht Version 1.5d Ereigniss OnCalClick Ereigniss OnCalOpen Ereigniss OnCalClose Ereigniss OnSpinDownClick Ereigniss OnSpinUpClick 3. Eigenschaften und Ereignisse ( Properties and events ) Folgende Eigenschaften und Ereignisse gelten für beide Komponenten TSpinDblEdit, TDBSpinDblEdit Properties : ActiveColor TColor, default clWindow Alignment default taRightJustify AutoCalculator boolean, pops the calculator OnEnter, default False CalcColor TColor, default clBackGround CalcDigitsNo Integer, different DigitsNo for Calculator, result will be rounded. Please set after DigitsNo. Calculator boolean, Calculatorbutton on/off, default off CalcHelpContext Integer, HelpContext for Calculator CalcPosition Position of Calculatorform, default posAbove [posAbove,posBelow,posLeft,posRight,posOnTop] DigitsNo Integer, Digitsnumber default 2, Min 0 , Max 10 Increment double, Increment for spin Info InfoMessageBox about this component MaxLength integer, MaxLength of number (incl. Decimalseparator), default 10, Max 30, Min 1 ( DigitsNo = 0 ) Normally calculated from Max-/MinValue MaxValue Double MinValue Double. If MinValue> = 0 and MaxValue<>MinValue then you can't entry negative number NegColor TColor, color negative Value NegFontColor TColor, fontcolor negative Value PosFontColor TColor, fontcolor positive Value Spin boolean, Spinbuttons on/off, default off If Spin is on use the Incrementvalue like TSpinEdit (standard Delphi component ) ThousSeparator boolean, Thousandseparator in Value, default True Value Double Events OnCalClick Calculator button click OnCalOpen Calculator open OnCalClose Calculator close OnSpinDownClick Down button click OnSpinUpClick Up button Click Additional the TDBSpinDblEdit have follows properties DataField NumericalField , Datatype ftSmallint, ftInteger, ftWord, ftFloat, ftCurrency DataSource DataSource for Table or Query Andere Eigenschaften sind aus der TCustomerEdit-Klasse vererbebt. 4. Beschreibung TSpinDblEdit dient der Vereinfachung der Eingaben und /oder Berechnung von realen und ganzen Zahlen. Die standardmäßig mitgelieferten Werkzeuge von Borland sind nur sehr eingeschränk zu gebrauchen ( s. TMaskEdit). Die Eingabe der Zahlen in TSpinDblEdit erfolgt wie bei einem Taschenrechner : Vorkommastellen von rechts nach links, Nachkommastellen von links nach rechts. Bei Eingabe vom Negationszeichen wird die aktuelle Zahl sofort negiert. Der Unterschied zum Taschenrechner besteht natürlich in den Editierfähigkeiten und den vom Programmierer fest vorgegebenen Nachkommastellen und maximalen Anzahl der Vorkommastellen. Bei einer normalen Zahleneingabe werden die Vorkammastellen von links aufgefüllt und beim erreichen der vom Programmierer festgelegten maximalen Vorkommastellenanzahl zu der ersten Nachkommastelle gewechselt. Beim Drücken des Dezimalzeichens springt der Cursor automatisch auf die erste Nachkommastelle. Alignment setzt die Ausrichtung der Zahl im Eingabefeld : rechts ( standart), zentriert oder linksbündig. DigitsNo ist die Anzahl der Nachkommastellen. Wenn keine Zahlen eingegeben werden wird immer mit Null aufgefüllt ( z.B. 1.00 wenn DigitsNo = 2). Wenn die Eigenschaft ThousandSeparator auf True gesetzt ist werden die Tausendertrennzeichen automatisch eingefügt und vom Cursor übersprungen. NegColor und NegFontColor erlaubt ihnen eine andersfarbige Darstellung der negativen Zahlen zur optischen Hervorhebung. MinValue, MaxValue und Maxlength sind Eigenschaften zum setzen der max. bzw. mindest Werte. Diese Eigenschaften beinflußen sich gegenseitig. Unsinnige Eigenschaften werden weitgehends abgefangen ( z. B. MinValue > MaxValue , MaxLength < Length(MaxValue) usw. ) . Value ist der aktuelle Anfangswert der Eingabe nach Erstellung der Form. Spin ermöglicht Ihnen eine einfache Addition bzw. Subtraktion der aktuellen Eingabe um den in der Eigenschft Increment eingegebenen Zahl indem Sie das Symbol Pfeil nach unten (Subtraktion) oder das Symbol Pfeil nach oben ( Addition ) drücken. Sie können auch die Tasten Pfeil nach oben bzw. Pfeil nach unten benutzen. Calculator erlaubt Ihnen dem Anwender einen Taschenrechner zur Verfügung zu stellen. Nach dem anklicken des Symbols für den Taschenrechner wird ein Taschenrechner angezeigt mit dem der Anwender Berechnungen anstellen kann und danach das Ergebnis in das Eingabefeld übernehmen kann. Der Taschenrechner ist ein nicht modales Fenster ohne Rahmen. Er wird geschlossen durch : 1. drücken der -Taste, Ergebniss wird übernommen 2. Anclicken des Schalters '<=' (Übernahme) , Ergebniss wird übernommen 3. drücken der , Abbruch 4. Klicken mit der Mouse außerhalb des Taschenrechnerfensters, Abbruch Forhandene Funktionen sind Addition, Subtraktion, Multiplikation, Division, Prozentrechnung, Memory-Berechnung. Die zusätzlichen Eigenschaften der TDBSpinDblEdit-Komponenten dienen der direkten Datenbankanbindung und können zur Anzeige bzw. Manipulation der Daten der verbundenen Felder einer Tabelle oder Anfrage benutzt werden. DataField kann sowohl einen integer wie auch einen float Typ angeben. Wenn die verbundene Tabelle/Anfrage währen des Setzens der Eigenschaften von TDBSpinDblEdit in der Entwicklungsumgebung aktiv ist ( d.h. die Eigenschaften des verbundenen Feldes sind bekannt ) werden die Eigenschaften MaxValue, MinValue und DigitsNo automatisch denen des verbundenen Feldes gleichgesetz und müssen nicht mehr nachbearbeitet werden. Andere Eigenschaften sind aus der TCustomerEdit-Klasse übernommen worden. 5. Registrierung Die Demo-Version beinhaltet alle Funktionen der Vollversion, kann aber seit dieser Version nur unter der Entwicklungsumgebung eingesetzt werden. Bemerkung : für C++ Builder bitte nur mit Source-Code registrieren !!! Registrierung Der Preis für diese Komponenten ist - $15.00 (US) ohne SourceCode - $30.00 (US) mit SourceCode ( >2000 Zeilen). Bestellen können Sie wie folgt : a. CompuServe's Online Registration : GO SWREG TSpinDateEdit : -File-ID 14245 without Source -File-ID 14900 with Source TGermDateEdit : -File-ID 15615 without Source -File-ID 15616 with Source Update from TSpinDateEdit : -File-ID 15617 without Source Update from TSpinDateEdit : -File-ID 15618 with Source TSpinDblEdit : -File-ID 12832 without Source -File-ID 14901 with Source b. Order by sending me an e-Mail. c. Fill out and send the order form "order.txt" 6. Glossar Wenn Sie Fragen oder Anregungen haben schicken Sie mir ein paar Zeilen per eMail. Ich bin für jeden guten Vorschlag dankbar. MfG Ihr Wilhelm Braun eMail : 106216.1307@compuserve.com Fax : +49 0621 6296754 7. Warranty THIS SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OR MERCHANTABILITY. THESE COMPONENTS ARE PROVIDED WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES WHATSOEVER. BECAUSE OF THE DIVERSITY OF CONDITIONS AND HARDWARE UNDER WHICH THESE COMPONENTS MAY BE USED, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. THE USER IS ADVISED TO TEST THESE COMPONENTS THOROUGHLY BEFORE RELYING ON THEM. THE USER MUST ASSUME THE ENTIRE RISK OF USING THESE COMPONENTS. 8. Shareware THESE COMPONENTS ARE SHAREWARE. You may use the shareware version of these components for a 30 day trial period. If you would like to continue to use these components after the 30 day trial period, you are required to purchase the licensed version of these components.